
Authentic SPI - SPI/Microwire Virtual Peripherals for SX-28 

Synchronous serial interfaces are widely used to provide economical board-level interface 
between different devices such as microcontrollers, DACs, ADCs and other. Although there is 
no single standard for the synchronous serial bus, there are industry accepted guidelines 
based on two most popular implementations: SPI (a trademark of Motorola Semiconductor) 
and Microwire (a trademark of National Semiconductor). These interfaces use master-slave 
model and typically have three signal lines: data input line, data output line and clock line. 
Chip select signals from the master are used to address different slaves on the bus. The 
hardware realization of such an interface is a simple shift register. The data bits are shifted 
in/out MSB (most significant bit) first. Often the data is shifted simultaneously out from the 
output pin and in to the input pin. 

The primary difference between the SPI and the Microwire is that SPI supports data locking 
on both falling and rising edges of the clock signal while the latter is always operating on the 
rising edge. Many IC manufacturers produce components that are compatible with SPI and 
Microwire. Since both standards define only the communication lines and the clock edge, 
other parameters vary for different devices. Clock frequencies happen to be anywhere from 
100kHz to a few MHz and word lengths are from 8 to 16 or more bits. This makes it hard to 
create a single virtual peripheral (VP) that would work for all of these situations. Therefore a 
family of SPI/Microwire VPs optimized for different operating conditions was created: 

SPIM high bit-rate (1 .72 - 0.2 MHz clock frequency) master mode VP 

SPIS high bit-rate (1 .1 and lower clock frequency) slave mode VP 

SPIML low bit-rate (330 - 0.7659KHz clock frequency) master mode VP 

SPIG general SPI driver, which supports all the modes 

All virtual peripherals support word lengths anywhere from 1 to 16 bits. SPIM VP does not use 
any interrupts; SPIS uses wake-up interrupts from port B (therefore is limited to PORTB pins 
only); and the SPLML uses RTCC interrupts to generate slow clock while freeing the 
processor for other activities in between. 

Three demo programs were created to demonstrate the operation of SPI virtual peripherals. 

The SPI Demo #1 uses SPIML VP working with two serial devices: the 12-bit ADC (Linear 
Technology LTC1594) and the 12-bit DAC (LTC1453). Special SPI evaluation board was 
developed for this demo program. The program executes the cycles of analog to digital 
conversion followed by digital to analog conversion. 

The SPI Demo #2 program is similar to the #1 with the difference that the processing of 
sample data is offloaded to another SX-28 microcontroller. After the sample is acquired by the 
master SX-28, it is then transferred via high speed SPI to the slave SX-28, processed, 
transferred back and then output to the DAC. 

The SPI Demo #3 demonstrates operation of high-speed data transfer between SPIM and 
SPIS, running on different SX microcontrollers. 

Extensive documentation and source files are included. 
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SERIAL PERIPHERAL INTERFACE (SPI) DRIVER 
SPI_ML 

Revision 1.01, 07.05.98 

Developed by Authentic Engineering for Scenix Semiconductor, Inc. 
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MASTER MODE LOW RATE SPI DRIVER. SINGLE MASTER CONFIGURATION 

This driver provides SPI interface to realtively slow devices. 

The data are transfered by words. Word length is software configurable 

from 1 to 16 bits . 

This driver is a part of a set of SX SPI drivers. It makes use of general 
set of control and status data, developed for the entire family of drivers 

CLOCK RATE 

The SPI clock rate is driven by the system RTCC . 

Minimum clock rate is limited by the RTCC prescaler setting which should be 
configured by the user. When the RTCC is configured to the minimum rate and 
prescaler is set to 1:2, the SPI clock rate will be equal to 10.2 microsec. 
With the prescaler setting at 1:256 the minimum clock rate will be 1.3056 m 
Maximum clock rate can be achived at RTCC prescaler setting 1:2 
and RTCC reload register - $80. Desierable configuration of the RTCC presc 
must be determined by the user. 

Clock (SCLK) PHASE and POLARITY are software configurable. 

There are FOUR basic signal lines associated with the SPI protocol: 

Master-Out-Slave-In MOSI signal line 

Master-In-Slave_0ut MISO signal line 

Serial Clock SCLK signal line 

Slave Select SS signal line 

Arbitrary pins of the SX-2 8 can be used for current driver 



INITIALIZATION OF SPI DRIVER 
USER program must : 

1. Provide appropriate configuration of the SX-28 ports. 

2. Define next parameters: 

SPI_RAM_BANK - to define the origin in SX RAM banks 

SPI_CL0CK_RATE - to define the clock rate. This byte is used by the driver 

as the RTCC reload register value 
SPI_C0MMAND - command and configuration byte. This byte defines: 

- SPI Clock polarity 

- Mode (Master or Slave) 

- Speed (Fast or Slow) 

- Direction (Read/Write) 

- Word Lenght (1 to 16) . 

Driver will set the RTCC reload value to the SPI_CL0CK_RATE . The USER 
program must take care about restoration of the RTCC reload value, after 
the SPI driver will complete its operation. 
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j Current driver support only Master Mode and Slow Speed data transfer. 

; The driver supports 5 commands, specified by the 4 MSBs of the SPI_COMMAND 

$0 RESET 

$2 GET WORD in MASTER mode, define FALLING edge 

$6 GET WORD in MASTER mode, define RISING edge 

$A SEND WORD in MASTER mode, define FALLING edge 

$E SEND WORD in MASTER mode, define RISING edge 

; Generally for the SPI interface there is no diffrence between GET and SEND, 

; however it seems convinient to have different commands, because it allows t 

; transmit and receive cycles for specific peripherals. Such an examle is pre 

; Four LSBs of SPI_COMMAND byte are used for word length definition. 

; $1 corresponds to one bit length 

; $F corresponds to fifteen bit legth 

; $0 corresponds to sixteen bit length 

; For example, SPI_COMMAND for 12 bit data transfer to the peripheral looks 1 

; 3. Driver is driven by RTCC interrupts. In order to start data transfer USE 

; must: 

- check that SPI_BUSY flag is cleared 

- set SPI_CLOCK_RATE and SPI_COMMAND 
; - enable timer interrupts 

; - perform JMP SPI_ENTRY when RTCC interrupt occures 

See example in DEMO #1 



The SPI_STATUS byte provides the information on driver status. It consists 
flags, described in the comments to the code. 



SX-28 pin assignment presented below is an example used in 
program. 

================= CODE START 



'SPI DEMO #1' 



device pins28, pages4 , banks8 
device turbo, stackx, optionx 
id 'SPI_ML' 

========= PIN ASSIGNMENT 

example of pin assignment used in DEMO #1 



spi_clk_pin 

spi_out_pin 

spi_in_pin 

spi_ADC_cs_pin 

spi_DAC_cs_pin 



spi_ram_bank 

sp i_c ommand 

bit_wide_0 
bit wide 1 



org 

ds 

equ 
equ 



rb.O ;SPI clock line 

rb.l ;master_in slave_out line 

rb.2 ;master_out slave_in line 

rb.4 ; slave select (ADC) 

rb.5 ; slave select (DAC) 

SPI DEVICE RAM ORIGIN 



lOh 
$ 



/example of RAM bank assignment 



spi_command. 
spi_command . 1 



;the word length LSB 
; 1 ft bit 



ftp://ftp.scenix.com/vps/spi_ml.src 



8/31/1999 



Page 3 of 5 



bit wide 2 




equ 




spi command. 2 


2_nd bit 


"h "i t~ wi Hp 

1 L. W _1_ V_J. *d J 








bpi ULUlllCilld . -3 


L-ilfcr wuiu ±ciiyuii l v loD 


iao L WIN 










fact- 11 rAol l v lULJli 


master_ON 




equ 




spi command. 5 


set if MASTER MODE 


rising_ON 




equ 




spi_command . 6 


set if RISING EDGE 


tran^mi t ON 




equ 




spi_command . 7 


set if TRANSMIT 










SPI_STATUS byte 




spi status 




ds 




1 




O k_/ _L_ X CCIU » 




ecfu. 




spi_status.O ;SET when driver is ready (has been 






ecju. 




spi_status . 1 


set when data transfer is active 


; spi_master 




equ 




spi_status . 2 


SET when SPI master is inited 


; spi_slave 




equ 




spi_status . 3 


SET when SPI slave is inited 


spi command ERR 




equ 




spi_status . 4 


set when command byte containes no 


spi_tx_complete 




equ 




spi status . 5 


transmit complete 


spi_rx_complete 




equ 




spi status . 6 


receive complete 


, bp± CI lUl 




equ 




spi_status . 7 


SET when transmit is not finished 


; spi rx complete 


and 


spi tx 


complete flags are needed when two different SS lines w 


, cillLI ICLClvc dllU 


transmit are controled in the same time. Otherwise, this flag is n 


• { cpp qnj qpT 
z Ibcc o Jr -L l v l , o r J. 


_S SPI drivers) 














SPI_STATE byte 




bp_L bLdLc 




ds 




1 




spi_ms_ON 




equ 




spi_state . 


set when Master Mode 


spi_sl_ON 




equ 




spi state. 1 


set when Slave Mode 


spi rx ON 




equ 




spi state. 2 


set when Receive Mode 


spi tx ON 




equ 




spi state. 3 


set when Transmit Mode 


spi_clk_state 




equ 




spi_state . 4 


state of the SPI_CLOCK line; 


;spi timer IRQ ON 


equ 




spi state. 5 


SPI transfer under timer IRQ ; in 


; spi_port_IRQ_ON 


equ 




spi state. 6 


SPI transfer under port IRQ : in 










SPI_CLOCK byte 




spi_clk_rate 




ds 




1 ;RTCC reload value 


spi_buf f 




ds 




1 


■SPI I/O shift register (MSByte) 


spi buff low 




ds 




1 


■SPI I/O shift register (LSByte) 


spi shift counter 


ds 




1 


shift counter 


spi_bits_total 




ds 




1 ; number of bits to transfer 


spi_shif ts_init 




ds 




1 ; number of initial shifts before tr 


spi_clk_counter 




ds 




1 


used only for DEMO #1 with LTC1594 


spi_clks_init 




ds 




1 ;used only for DEMO #1 with LTC1594 










INTERRUPT START 




spi_entry 


bank 


spi_ 


ram bank ;SPI driver entry point 




jb 


master_ 


ON , ma s t e r_ent ry 






snb 


rising_ 


ON 






setb 


spi_ 


command_ERR ; return from interrupt if wrong com 




snb 


transmit ON 






setb 


spi 


command ERR 





clr 



spi_command 
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setb 

mov 
retiw 



spi_ready 

w, spi_clk_rate 



master_entry 



:init master 



: set_bit_position 



test 
jnz 

jb 

setb 
setb 

sb 

setb 

snb 

setb 

snb 

clrb 



snb 
clrb 

sb 

clrb 
snb 
setb 
sb 

clrb 

snb 

setb 

mov 

and 

mov 

mov 

or 

mov 

not 

inc 

mov 

clc 

rl 

mov 
clc 
rl 

test 

clc 

sz 

rl 

sz 

rl 

sz 

djnz 



SPI MASTER ENTRY 

spi_shif t_counter 
:master start 



;test if this is first entr 



spi_ms_ON, :ms_rx_f inish /initialization of the driv 

spi_busy_ON 
spi_ms_ON 



transmit_ON 

spi_rx_ON 

transmit_ON 

spi_tx_ON 

spi_rx_ON 

spi_ADC_cs _pin 



spi_tx_ON 
spi_DAC_cs_pin 

rising_ON 

clk_state 

rising_ON 

clk_state 

rising_ON 

spi_clk_pin 

rising_ON 

spi_clk_pin 



/this is an example to show 
/generate CS signals for a 
/peripherals. This is CS fo 

/CS for DAC 

/set the SPI_CLK polarity 



w, spi_command 
w, #%00001111 
spi_bits_total , w 
w, spi_command 
w, #%11110000 
spi_shif ts_init , w 
spi_shif ts_init 
spi_shif ts_init 

spi_shif t_counter , spi_bits_total 
spi_shif t_counter 
spi_clk_counter , spi_clks_init 
spi_clk_counter 



/ set the number of bits to 



/Example for LTC15 9 
/LTC15 94 input MX c 
/end of LTC15 94 par 



spi_shif ts_init 



initial shift before trans 
needed to put MSB of the w 
bit. 7 SPI_BUFF position 



spi_buf f_low 
spi_buf f 

spi_shif ts_init , : set_bit_position 
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3 m P 



:master exit 



:master start 



: master rx 



:master tx 



:ms rx finish 



:ms tx finish 



:master finish 



:master exit 



nop 
test 

jz 

xor 

dec 

jmp 



jb 

movb 

rl 

rl 

setb 
dec 
setb 
jmp 

movb 

clrb 

dec 

clrb 

jmp 

sb 

jmp 

setb 

setb 

clrb 

jmp 

setb 
clrb 
setb 
jmp 

clrb 

clr 

clrb 

mov 
retiw 



spi_clk_counter 
: master_rx 
rb, #%00000001 
spi_clk_counter 

:master exit 



clk_state, :master_tx 
c , spi_in_pin 
spi_buf f _low 
spi_buf f 
spi_clk_pin 
spi_shif t_counter 
clk_state 
: master_exit 

spi_out_pin, spi_buf f . 7 

spi_clk_pin 

spi_shif t_counter 

clk_state 

:master_exit 

spi_rx_ON 

:ms_tx_f inish 

spi_rx_complete 

spi_ADC_cs_pin 

spi_rx_ON 

: mas ter_f inish 

spi_DAC_cs_pin 
spi_tx_ON 
spi_tx_complete 
: mas ter_f inish 

spi_ms_ON 

spi_command 

spi_busy_ON 

w, spi_clk_rate 



/initialization done, first 

Example of the LTC1594 driv 

Example for LTC1594 ADC on 
Jump to normal master rece 
LTC1594 input MX control 
sclk ADC UP/DOWN 

; interrupt exit for the ADC 

End of ltcl594 example 

;bit reception from SPI_IN_ 



;bit received 
;bit transmit 

;bit transmitted 

/reception completed 

,-correct reception finished 
/disable ADC CS 



/disable DAC CS 
/transmission completed 



END OF MASTER MODE SLOW SPI DRIVER 
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